home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / hslk11b7.zip / HSLINK.DOC < prev    next >
Text File  |  1992-01-29  |  92KB  |  2,342 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                     ▒▒▒▒▄ ▒▒▒▒▄   ▒▒▒▒▒▒▒▒▄
  10.                      ▒▒█▀  ▒▒█▀   ▒▒█▀▀▀▒▒█    HS/Link
  11.                      ▒▒█   ▒▒█    ▒▒█    ▀▀
  12.                      ▒▒▒▒▒▒▒▒█    ▒▒▒▒▒▒▒▒▄    High Speed Link
  13.                      ▒▒█▀▀▀▒▒█      ▀▀▀▀▒▒█
  14.                      ▒▒█   ▒▒█    ▒▒▄   ▒▒█    File Transfer Protocol
  15.                     ▒▒▒▒█ ▒▒▒▒█   ▒▒▒▒▒▒▒▒█
  16.                      ▀▀▀▀  ▀▀▀▀    ▀▀▀▀▀▀▀▀
  17.  
  18.  
  19.                                        HS/Link
  20.  
  21.                                      Version 1.01
  22.  
  23.                        Copyright (C) 1991, 1992 Samuel H. Smith
  24.                             All Rights Reserved, Worldwide
  25.  
  26.  
  27.                               PLEASE REFER TO HSLINK.NEW
  28.                         FOR DETAILS OF RECENT PROGRAM CHANGES!
  29.  
  30.  
  31.           HS/Link is a high speed, full streaming, bidirectional, batch
  32.           file transfer protocol with advanced Full-Streaming-Error-
  33.           Correction.  Each side of the link is allowed to provide a list
  34.           of files to be sent.  Files will be sent in BOTH directions until
  35.           both sides of the link are satisfied.
  36.  
  37.           HS/Link is not just another bidirectional protocol, it is also a
  38.           very fast protocol for normal downloading and uploading,
  39.           incorporating some new ideas (such as Full-Streaming-Error-
  40.           Correction and Dynamic-Code-Substitution) to make things happen a
  41.           bit faster and with greater reliability.
  42.  
  43.           This program is not free!  You are hereby licensed to use this
  44.           program for a trial period of 30 days free of charge.  If, after
  45.           30 days, you decide that you would like to continue using HSLINK,
  46.           you must complete the registration form (REGISTER.FRM) and return
  47.           it to the author with the required registration fee enclosed.
  48.  
  49.           Registration removes the "UNREGISTERED" message and also enables
  50.           a bar-graphic display of file transfer status, an estimation of
  51.           remaining time to transfer each file, and a calculation of
  52.           combined thruput during bidirectional transfers.
  53.  
  54.           Please feel free to distribute HSLINK to your friends and local
  55.           BBSes as long as all of the files in this archive are included
  56.           and unmodified.
  57.  
  58.           See the LICENSE AND REGISTRATION section of this document for
  59.           more details.
  60.  
  61.           HS/Link 1.0 User Documentation                                  1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                   Table of Contents
  69.           _________________________________________________________________
  70.  
  71.           Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   3
  72.  
  73.           Full Screen Status Display  . . . . . . . . . . . . . . . . .   5
  74.  
  75.           Command Line Format . . . . . . . . . . . . . . . . . . . . .   6
  76.  
  77.           Basic Command Line Options  . . . . . . . . . . . . . . . . .   6
  78.  
  79.           HS/Link Configuration Manager . . . . . . . . . . . . . . . .   8
  80.  
  81.           Advanced Command Line Options . . . . . . . . . . . . . . .    13
  82.  
  83.           Command Line Examples . . . . . . . . . . . . . . . . . . .    18
  84.  
  85.           Calling HS/Link from COMM programs  . . . . . . . . . . . .    19
  86.  
  87.           Calling HS/Link from BBS programs . . . . . . . . . . . . .    20
  88.  
  89.           Flow Control  . . . . . . . . . . . . . . . . . . . . . . .    22
  90.  
  91.           Full Streaming Data Transmission  . . . . . . . . . . . . .    24
  92.  
  93.           Full Streaming Error Recovery . . . . . . . . . . . . . . .    25
  94.  
  95.           Dynamic Code Substitution . . . . . . . . . . . . . . . . .    26
  96.  
  97.           Transmission of Minimal Blocks  . . . . . . . . . . . . . .    26
  98.  
  99.           DSZLOG Statistic Logging  . . . . . . . . . . . . . . . . .    27
  100.  
  101.           Network Compatibility . . . . . . . . . . . . . . . . . . .    28
  102.  
  103.           Auto Downloading  . . . . . . . . . . . . . . . . . . . . .    29
  104.  
  105.           Error Messages  . . . . . . . . . . . . . . . . . . . . . .    30
  106.  
  107.           License and Registration  . . . . . . . . . . . . . . . . .    36
  108.  
  109.           Index . . . . . . . . . . . . . . . . . . . . . . . . . . .    38
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.           HS/Link 1.0 User Documentation                                  2
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                      Introduction
  129.           _________________________________________________________________
  130.  
  131.           What is a file transfer protocol?
  132.  
  133.           A file transfer protocol is a means of transferring information
  134.           from one computer to another.  The protocol has the
  135.           responsibility of protecting against errors in transit, and
  136.           taking measures to correct any errors that are detected.  The
  137.           design and implementation of a protocol can make the difference
  138.           between slow and unreliable communication, and fast and trouble
  139.           free communication.
  140.  
  141.           Not all protocols are created equal.  With today's high speed
  142.           modems, packet switched networks (such as PC Pursuit), and
  143.           expensive long distance charges, users demand more than ever that
  144.           files get through quickly and without corruption.
  145.  
  146.           The HS/Link protocol is the result of years of communication
  147.           experience, and uses some very new and solid technology to see to
  148.           it that you can easily move files as quickly as possible, and
  149.           with the least amount of hassle.
  150.  
  151.           The HSLINK program can be used from the DOS command line, from
  152.           BATCH files, or as an "external protocol" from most modern COMM
  153.           programs and BBS programs.  If your favorite BBS does not yet
  154.           support the HS/Link protocol, please ask your SYSOP to install
  155.           it.
  156.  
  157.           Recent advances in high speed modem technology have made it
  158.           possible to simultaneously transfer data at high speeds in both
  159.           directions.  This standardized
  160.           technology is called "V.32", and  ┌───────────────────────────┐
  161.           is available in many new modems.  │Bidirectional features that│
  162.           Until HS/Link, these advanced     │really work...             │
  163.           modems were left half idle, due   │HS/Link can simultaneously │
  164.           to the single-direction nature    │send and receive files!    │
  165.           of prior file transfer            └───────────────────────────┘
  166.           protocols.  The bidirectional
  167.           capabilities of HS/Link take full advantage of these modems,
  168.           cutting online time as much as 50% when equal amounts of data are
  169.           transmitted and received.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.           HS/Link 1.0 User Documentation                                  3
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.                                Summary of Key Features
  189.           _________________________________________________________________
  190.  
  191.           ∙ Speed.
  192.                HS/Link operates at or very near peak efficiency, often
  193.                reaching 98% or more with pre-compressed files and non-
  194.                buffered modems.  Even higher speeds are possible with
  195.                buffered or error correcting modems.  A number of features,
  196.                such as fast 32 bit CRC protection, Full-Streaming-Error-
  197.                Recovery and Dynamic-Code-Substitution, combine to give
  198.                maximum performance and security.
  199.  
  200.           ∙ Simple interface for beginners.
  201.                In many cases, HS/Link requires only the COM port number and
  202.                the filename to be transmitted.  Configuration files are not
  203.                required.  The program is easily installed in most COMM
  204.                programs that support external protocols.  The HSLINK
  205.                program has multiple help screens, providing a quick
  206.                reference to the basic and advanced command line options,
  207.                including examples of how the program is used.
  208.  
  209.           ∙ Batch file transfers.
  210.                The protocol can handle any size batch of files, and can
  211.                take file specifications from either the command line or
  212.                from a listing file.
  213.  
  214.           ∙ Bi-directional options that really work.
  215.                The program can simultaneously upload and download with a
  216.                single host request.  What's even better is how easy it is
  217.                to use...  instead of a complex setup all you do is:
  218.  
  219.                1)   Tell the BBS the names of the files you want to
  220.                     download, and then
  221.  
  222.                2)   Press PGUP (or whatever your COMM program uses to
  223.                     UPLOAD files) and then tell your COMM program which
  224.                     files to upload
  225.  
  226.                By virtue of the BBS being told that it is sending files and
  227.                your COMM program telling HS/Link that it too is sending
  228.                files you then have a bidirectional transfer.  There's
  229.                nothing else to set up.  You use the familiar BBS interface
  230.                to request files to download and your COMM program's
  231.                familiar interface to tell it which files to upload.  It
  232.                couldn't get easier!
  233.  
  234.           ∙ Aborted file crash recovery.
  235.                When desired, HS/Link can resume an aborted transfer,
  236.                verifying all existing data blocks to insure the resumed
  237.                file completely matches the file being transmitted.  This
  238.                function can also update a file that has only a small number
  239.                of changed, added, or deleted blocks.
  240.  
  241.           HS/Link 1.0 User Documentation                                  4
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.                               Full Screen Status Display
  249.           _________________________________________________________________
  250.  
  251.           When HS/Link is operating, it produces a full screen status
  252.           display.  This display is divided into four windows.  Here is an
  253.           example of a status display:
  254.  
  255.   ╒══════ HS/Link  V1.00 (1/9/92)   Copyright 1992 Samuel H. Smith ═══════╕
  256.   │ Serial Number: 00001.   Thank you for registering!                    │
  257.   │ Command line: -E2400 -UJ:\ZDL -o -k -P1 c:\tmp\*.*                    │
  258.   └───────────────────────────────────────────────────────────────────────┘
  259.   ╒═════════  Receiver (InComing Files)  ════════╕ ╒═════  Settings  ═════╕
  260.   │                                              │ │                      │
  261.   │ J:\ZDL\ATSEND.ZIP (12 blocks, 11777 bytes)   │ │  COM1 open at: 19200 │
  262.   │ File received OK, 202 cps, 1.0 minutes.      │ │Remote Serial#: 00001 │
  263.   │ J:\ZDL\HOUSE.ZIP (33 blocks, 32917 bytes)    │ │Remote Version: 1.00  │
  264.   │ Block 25 (25600 bytes) 280 cps               │ │        Window: NONE  │
  265.   │ ████████████████████████░░░░░░░░  0.5 minutes│ │    Block size: 2048  │
  266.   └──────────────────────────────────────────────┘ │      XON/XOFF: ON    │
  267.   ╒════════  Transmitter (OutGoing Files)  ══════╕ │ CTS handshake: ON    │
  268.   │                                              │ │ RTS handshake: ON    │
  269.   │ c:\tmp\SLWTX120.ZIP (59 blocks, 119698 bytes)│ │Slow handshake: OFF   │
  270.   │ Block 24 (49152 bytes/w:24) 298 cps          │ │        Resume: OFF   │
  271.   │ █████████████░░░░░░░░░░░░░░░░░░░  4.0 minutes│ │  Keep partial: ON    │
  272.   │                                              │ │     Overwrite: ON    │
  273.   │                                              │ │                      │
  274.   └──────────────────────────────────────────────┘ └  ^X^X^X^X to abort!  ┘
  275.         Total of 86529 bytes transferred.  Combined thruput 562 cps.
  276.  
  277.           The first window contains the program identification and
  278.           copyright.  When you register your copy of HSLINK, this window
  279.           will also show the registered serial number.  Some warning
  280.           messages may also appear in this window
  281.  
  282.           The "settings" window shows a summary of the various parameters
  283.           that can be altered with command line options.
  284.  
  285.           The "receiver" window shows the status of files being received
  286.           from the remote system.
  287.  
  288.           The "transmitter" window shows the status of files being
  289.           transmitted to the remote system.
  290.  
  291.           To stop display bleedthrough under DesqView or DoubleDOS, use the
  292.           -NV option to disable direct video writing.  The result will be a
  293.           slightly slower display, but it will not bleed from one partition
  294.           to another.
  295.  
  296.           If desired, the full screen status display can be turned off.  To
  297.           do this, use the -NF command line option.  When running in -NF
  298.           mode, a simple line-oriented status display will scroll down the
  299.           screen.  This may be desired under some circumstances.
  300.  
  301.           HS/Link 1.0 User Documentation                                  5
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.                                  Command Line Format
  309.           _________________________________________________________________
  310.  
  311.           To run the HSLINK program, a command line must be given.  The
  312.           command line has the following format:
  313.  
  314.           HSLINK [options] [SENDFILE] [@DRIVE:\PATH\FILELIST]
  315.  
  316.           SENDFILE  Indicates a list of files to be transmitted to remote
  317.                     computer.  The list may include the DOS wildcard
  318.                     characters '?' and '*'.  Specify ONLY files to be
  319.                     transmitted; received file names are determined
  320.                     automatically.
  321.  
  322.           @FILELIST Transmit list of files contained in FILELIST to remote
  323.                     computer.  This is used when you want to make a long
  324.                     list of files in advance, then transmit them all with a
  325.                     single command.  It is also used by BBS programs to
  326.                     produce long batches of downloads.
  327.  
  328.           ∙    Anything shown in brackets "[]" is optional and may not need
  329.                to be specified for proper operation of HS/Link.
  330.           ∙    The HSLINK command line is NOT case sensitive, and will work
  331.                when typed in upper, lower or mixed case.
  332.           ∙    Please make sure that HSLINK.EXE is in a search PATH
  333.                directory.
  334.  
  335.                               Basic Command Line Options
  336.           _________________________________________________________________
  337.  
  338.           The most important command line options are -P (set COM port), -U
  339.           (set download file directory), and -HS (enable slow handshake).
  340.  
  341.           -Pport    This option specifies which COM port you are using.
  342.                     Example:  -P2
  343.  
  344.           -Udir     This option controls the destination directory for
  345.                     downloaded files.  Without this option, all download
  346.                     files are placed into the current directory.
  347.                     Example:  -Uc:\bbsfiles
  348.  
  349.           -HS       Handshake Slow (send XOFF and/or lower RTS during disk
  350.                     I/O).  This option may be required if your computer is
  351.                     unable to simultaneously access the disk and the COM
  352.                     port.  If you see frequent CRC error messages, even on
  353.                     clean phone lines, you probably need to include -HS in
  354.                     your command line.
  355.  
  356.           To abort an HS/Link transfer, press Control-X four or more times.
  357.  
  358.  
  359.  
  360.  
  361.           HS/Link 1.0 User Documentation                                  6
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.                                  Configuration Files
  369.           _________________________________________________________________
  370.  
  371.           Because of the large number of possible command line options, it
  372.           is possible to store frequently used command options in a
  373.           configuration file.  This
  374.           eliminates the need to            ┌────────────────────────┐
  375.           repeatedly type the options at a  │HS/Link does NOT require│
  376.           command line.  If you are         │configuration files.    │
  377.           calling HSLINK from multiple      └────────────────────────┘
  378.           batch files, you can also use
  379.           configuration files to store "common" options, that can be
  380.           changed in one place rather than separately in the various batch
  381.           files.
  382.  
  383.           HSLINK will search the current
  384.           directory and then the PATH       ┌───────────────────────────┐
  385.           directories for HSLINK.CFG.  If   │For best results, add your │
  386.           this file is found, each file     │HS/Link or COMM program    │
  387.           line is loaded as a command line  │directory to your PATH     │
  388.           option.                           │statement.                 │
  389.                                             └───────────────────────────┘
  390.  
  391.  
  392.           If you want to use an alternate configuration file, use the
  393.           -@fname command line option, which will cause 'fname' to be
  394.           loaded.  For example:
  395.                HSLINK -@C:\WORK\TOLAP.CFG
  396.           will cause HSLINK to use C:\WORK\TOLAP.CFG as the configuration
  397.           file.
  398.  
  399.  
  400.           If -@fname is not the first command line option, the default
  401.           HSLINK.CFG file will be searched for and loaded before the
  402.           specified configuration file.
  403.  
  404.  
  405.           Use -@ (without a filename) to prevent HSLINK from searching for
  406.           a configuration file, slightly speeding operation on systems that
  407.           have a long search PATH setting in effect.
  408.  
  409.  
  410.           To aid in creation and
  411.           alteration of configuration       ┌───────────────────────────┐
  412.           files, the HS/Link Configuration  │Use HSCONFIG to create and │
  413.           Manager program, HSCONFIG, was    │edit HS/Link option        │
  414.           written.                          │(configuration) files.     │
  415.                                             └───────────────────────────┘
  416.  
  417.  
  418.  
  419.  
  420.  
  421.           HS/Link 1.0 User Documentation                                  7
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.                             HS/Link Configuration Manager
  429.           _________________________________________________________________
  430.  
  431.           HSLINK includes the HS/Link Configuration Manager program,
  432.           HSCONFIG.EXE.  With this program you can easily manipulate most
  433.           of HS/Link's many options.
  434.  
  435.  
  436.           The opening display for HSCONFIG looks like this:
  437.  
  438.   Node-3 L:\HSL >HSCONFIG
  439.  
  440.  
  441.          ┌────────────────── New Configuration ─────────────────────┐
  442.          │                                                          │
  443.          │ The specified configuration file cannot be located.      │
  444.          │                                                          │
  445.          │ This probably indicates that you are creating a new      │
  446.          │ configuration for HS/Link.  All options will be set      │
  447.          │ to default values.                                       │
  448.          │                                                          │
  449.          │ Alternate configuration files can be specified on        │
  450.          │ the command line to HSCONFIG.  The default configuration │
  451.          │ file is HSLINK.CFG, and it may be located either in the  │
  452.          │ current directory, or in any PATH directory.             │
  453.          │                                                          │
  454.          │ Press <ENTER> or <ESC> to continue.                      │
  455.          │                                                          │
  456.          │  Index  <ESC>                                            │
  457.          └──────────────────────────────────────────────────────────┘
  458.  
  459.  
  460.  
  461.   Can't find: HSLINK.CFG
  462.  
  463.  
  464.           HSCONFIG can be used to edit any configuration file, but the
  465.           default is to edit HSLINK.CFG in the current directory.  If you
  466.           want to edit some other configuration file, you must specify the
  467.           filename on the HSCONFIG command line.  For example:
  468.  
  469.                HSCONFIG TOLAP.CFG
  470.  
  471.           will create or edit TOLAP.CFG, which can later be used by HSLINK
  472.           with a command line like this:
  473.  
  474.                HSLINK -@TOLAP.CFG
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.           HS/Link 1.0 User Documentation                                  8
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.           The primary screen in HSCONFIG is the "Basic Settings" screen,
  490.           which controls the most important settings for HS/Link operation. 
  491.           The other screens contain advanced settings that need not be
  492.           changed until you become more familiar with the program and begin
  493.           to explore the advanced capabilities.
  494.  
  495.    ╒════════════════════════ HS/Link: Basic Settings ════════════════════════╕
  496.    │                                                                         │
  497.    │    These are the most important settings for proper HS/Link operation   │
  498.    │                                                                         │
  499.    │  COM port number (1-8) . . . . . . . . . . . 1                          │
  500.    │                                                                         │
  501.    │  Directory for downloaded files. . . . . . . __________________________ │
  502.    │                                                                         │
  503.    │  Use "SLOW HANDSHAKE" during disk I/O. . . . N                          │
  504.    │                                                                         │
  505.    ╘═════════════════════════════════════════════════════════════════════════╛
  506.  
  507.               ┌──────────────────── Welcome! ───────────────────────┐
  508.               │ Welcome to the HS/Link Configuration Manager.       │
  509.               │ The easy way to handle HS/Link configuration files. │
  510.               │                                                     │
  511.               │ Use the arrow keys to select entries on this page.  │
  512.               │ Use the PgUp/PgDn keys to change pages.             │
  513.               │ Press ESC to save changes when you are finished.    │
  514.               │                                                     │
  515.               │ Use the F1 key to get HELP at any prompt.           │
  516.               └─────────────────────────────────────────────────────┘
  517.  
  518.   PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  519.  
  520.  
  521.           The HSCONFIG program contains context sensitive pop-up help for
  522.           each and every input prompt.  Simply press the F1 key to get an
  523.           explanation of the current entry.  For example:
  524.  
  525.          ┌───────────────────────────── -U ────────────────────────────────┐
  526.          │ -Udir  > Download directory.                                    │
  527.          │                                                                 │
  528.          │ This option controls the destination directory for downloaded   │
  529.          │ files.  Without this option, all download files are placed into │
  530.          │ the current directory.                                          │
  531.          │                                                                 │
  532.          │  Index  <ESC>                                                   │
  533.          └─────────────────────────────────────────────────────────────────┘
  534.  
  535.           When in the online help system, press the SPACE and BACKSPACE
  536.           keys to select from the topics available at the bottom of the
  537.           window, and press ENTER to select a topic.  Press ESCAPE to
  538.           return to the prior screen.
  539.  
  540.  
  541.           HS/Link 1.0 User Documentation                                  9
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.           The "Advanced COM Settings" screen determines the settings of
  550.           many communications related options.  See the following section,
  551.           "Advanced Options" for a description of each of these options.
  552.  
  553.   ╒════════════════════ HS/Link: Advanced COM Settings ═════════════════════╕
  554.   │                                                                         │
  555.   │         These settings control advanced communication features          │
  556.   │                                                                         │
  557.   │ Non-Standard COM base (in DECIMAL, 0 = standard COM port) . . . . 0░░░  │
  558.   │                                                                         │
  559.   │ Non-Standard COM IRQ (1-7, 0 = standard COM port) . . . . . . . . 0_    │
  560.   │                                                                         │
  561.   │ COM port open speed (300-115200, 0 = automatic) . . . . . . . . . 0____ │
  562.   │                                                                         │
  563.   │ Effective modem-to-modem speed (0 = same as open speed) . . . . . 0____ │
  564.   │                                                                         │
  565.   │ Enable CTS hardware handshake . . . . . . . . . . . . . . . . . . Y     │
  566.   │                                                                         │
  567.   │ Enable RTS hardware handshake . . . . . . . . . . . . . . . . . . Y     │
  568.   │                                                                         │
  569.   │ Enable XON/XOFF software handshake. . . . . . . . . . . . . . . . Y     │
  570.   │                                                                         │
  571.   │ Enable Carrier Detect checking. . . . . . . . . . . . . . . . . . Y     │
  572.   │                                                                         │
  573.   │ Preserve original time/date stamp on received files . . . . . . . Y     │
  574.   │                                                                         │
  575.   ╘═════════════════════════════════════════════════════════════════════════╛
  576.  
  577.   PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  578.  
  579.  
  580.  
  581.           This screen manipulates the following options:
  582.  
  583.           -PB (define non-standard COM base address), 
  584.           -PI (define non-standard COM irq), 
  585.           -B (COM port open speed), 
  586.           -E (effective modem to modem speed), 
  587.           -HC (disable CTS handshake), 
  588.           -HR (disable RTS handshake), 
  589.           -HX (disable XON/XOFF handshake), 
  590.           -C (disable carrier detect monitoring) and 
  591.           -NT (disable preservation of original date/time stamp) 
  592.  
  593.           These options will be described in detail in the next section.
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.           HS/Link 1.0 User Documentation                                 10
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.           The "Advanced Optional Features" screen controls many advanced
  610.           protocol features.  See the following section, "Advanced Options"
  611.           for a description of each of these options.
  612.  
  613.   ╒═════════════════ HS/Link: Advanced Optional Features ══════════════════╕
  614.   │                                                                        │
  615.   │            These settings control various optional features            │
  616.   │                                                                        │
  617.   │ Attempt to Resume aborted transfers . . . . . . . . . . . . . . . N    │
  618.   │                                                                        │
  619.   │ Keep partial files from aborted transfers . . . . . . . . . . . . N    │
  620.   │                                                                        │
  621.   │ Allow received files to overwrite/modify existing files . . . . . N    │
  622.   │                                                                        │
  623.   │ Enable file read/write buffering. . . . . . . . . . . . . . . . . Y    │
  624.   │                                                                        │
  625.   │ Enable "Dynamic-Code-Substitution" logic. . . . . . . . . . . . . Y    │
  626.   │                                                                        │
  627.   │ Size of transmitted data blocks (64-4096 bytes/block) . . . . . . 1024 │
  628.   │                                                                        │
  629.   │ Number of blocks in transit before ACK is required (0-20) . . . . 8_   │
  630.   │                                                                        │
  631.   │ Disable transmission of ACK for each block received . . . . . . . N    │
  632.   │                                                                        │
  633.   │ Force remote unit to use local option settings. . . . . . . . . . N    │
  634.   │                                                                        │
  635.   ╘════════════════════════════════════════════════════════════════════════╛
  636.  
  637.   PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  638.  
  639.  
  640.  
  641.           This screen manipulates the following options:
  642.  
  643.           -R (resume aborted transfers), 
  644.           -K (keep partial files), 
  645.           -O (allow overwrite of receive files), 
  646.           -NB (disable file buffering), 
  647.           -NC (disable dynamic code substitution), 
  648.           -S (data block size), 
  649.           -W (acknowledge window size), 
  650.           -A (disable receive acknowledge) and 
  651.           -! (force remote to use local options) 
  652.  
  653.           These options will be described in detail in the next section.
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.           HS/Link 1.0 User Documentation                                 11
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.           The "Screen Settings" screen allows you to control the format of
  670.           the status display screen, the colors to be used, and to enable
  671.           or disable direct-video screen updates.
  672.  
  673.   ╒═══════════════════════ HS/Link: Screen Settings ═══════════════════════╕
  674.   │                                                                        │
  675.   │           These settings control the screen format and colors          │
  676.   │                                                                        │
  677.   │ Enable Full-Screen status display . . . . . . . . . . . . . . . . Y    │
  678.   │ Enable direct video writing (turn off in DesqView/DoubleDOS/etc). Y    │
  679.   │                                                                        │
  680.   │ Color of BORDER in full screen mode . . . . . . . . . . . . . . . 7__  │
  681.   │ Color of PROMPTS in full screen mode. . . . . . . . . . . . . . . 47_  │
  682.   │ Color of WINDOW TITLE in full screen mode . . . . . . . . . . . . 79_  │
  683.   │ Color of WINDOW CONTENTS in full screen mode. . . . . . . . . . . 31_  │
  684.   │                                                                        │
  685.   ╘════════════════════════════════════════════════════════════════════════╛
  686.      ┌── Color Table ───────────────────────────────────────────────────┐
  687.      │   0   1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  │
  688.      │  16  17  18  19  20  21  22  23  24  25  26  27  28  29  30  31  │
  689.      │  32  33  34  35  36  37  38  39  40  41  42  43  44  45  46  47  │
  690.      │  48  49  50  51  52  53  54  55  56  57  58  59  60  61  62  63  │
  691.      │  64  65  66  67  68  69  70  71  72  73  74  75  76  77  78  79  │
  692.      │  80  81  82  83  84  85  86  87  88  89  90  91  92  93  94  95  │
  693.      │  96  97  98  99 100 101 102 103 104 105 106 107 108 109 110 111  │
  694.      │ 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127  │
  695.      └──────────────────────────────────────────────────────────────────┘
  696.  
  697.   PgDn [next page]     PgUp [prior page]             F1 [help]     ESC [exit]
  698.  
  699.  
  700.           This screen manipulates the following options:
  701.  
  702.           -NF (disable full screen status display), 
  703.           -NV (disable direct video screen updates), 
  704.           -CB (define border color), 
  705.           -CM (define main/prompt color), 
  706.           -CT (define title color) and 
  707.           -CW (define window contents color)
  708.  
  709.           These options will be described in detail in the next section.
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.           HS/Link 1.0 User Documentation                                 12
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.                             Advanced Command Line Options
  729.           _________________________________________________________________
  730.  
  731.           The HS/Link protocol program has a number of command line
  732.           options, most of which are rarely needed, or which are provided
  733.           for advanced users to obtain maximum performance and flexibility.
  734.  
  735.           -@fname
  736.                Uses fname as an alternate configuration file.  Each line in
  737.                the specified file may contain a single command line option. 
  738.                The default is to search PATH directories for HSLINK.CFG.
  739.  
  740.           -!
  741.                Take priority.  Locally specified -A, -HX, -S, and -W
  742.                settings will be used by the remote system.
  743.  
  744.           -A
  745.                Disable transmission of ACK codes after each block.  This
  746.                may improve transfer speeds under some conditions.
  747.  
  748.           -Bbaud
  749.                COM port opening baud rate   ┌───────────────────────────┐
  750.                300-115200 (default=current  │Don't use the -B option if │
  751.                port OPEN speed).            │you don't need to!  In most│
  752.                This option controls the     │cases HS/Link is able to   │
  753.                speed at which the COM port  │automatically determine the│
  754.                will be opened.              │proper port opening speed. │
  755.                                             └───────────────────────────┘
  756.                Normally, the COM port
  757.                speed can be determined from hardware and need not be
  758.                specified.
  759.  
  760.           -C
  761.                Disable carrier detect checking.
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.           HS/Link 1.0 User Documentation                                 13
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.           -CBcolor
  789.                Defines the border color in full screen mode.
  790.  
  791.           -CMcolor
  792.                Defines the main screen color in full screen mode.
  793.  
  794.           -CTcolor
  795.                Defines the window title color in full screen mode.
  796.  
  797.           -CWcolor
  798.                Defines the window contents color in full screen mode.
  799.  
  800.           -Ebaud
  801.                Effective modem-to-modem baud rate.
  802.                This is used to estimate transfer times, and is included in
  803.                the DSZLOG output.  (default=current -B setting)
  804.  
  805.           -HC
  806.                Disables CTS hardware handshake.
  807.                CTS transmitter handshake is automatically enabled, but may
  808.                conflict with some unusual modem cables or serial ports.  If
  809.                the CTS signal is not active when HSLINK loads, it will
  810.                automatically disable CTS handshake for you.  Use the -HC
  811.                command to manually disable CTS handshake.
  812.  
  813.           -HR
  814.                Disables RTS hardware handshake.
  815.                RTS receiver handshake is used when the slow-handshake
  816.                option is selected.  This form of handshake causes the RTS
  817.                line to the modem to be lowered whenever the disk is being
  818.                accessed.  Some unusual modem or cable arrangements may not
  819.                tolerate the RTS line being lowered.  In this case, the RTS
  820.                handshake can be disabled with the -HR option.
  821.  
  822.           -HS
  823.                Handshake Slow (send XOFF and/or lower RTS during disk I/O).
  824.                The slow handshake option is available for systems with slow
  825.                disk access.  Use this if you get frequent CRC errors or COM
  826.                Overrun errors on otherwise clean lines.  The slow handshake
  827.                option causes XOFF to be sent and/or RTS to be lowered
  828.                during any disk activity.  Even when -HS is active, the
  829.                HS/Link protocol should transfer data very nearly as fast as
  830.                the slowest part of the link allows.
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.           HS/Link 1.0 User Documentation                                 14
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.           -HX
  849.                Disable XON/XOFF handshake.
  850.                XON/XOFF handshake is a software handshake scheme that
  851.                should work well on all combinations of modems and networks,
  852.                and is enabled by default.  If you prefer not to use
  853.                XON/XOFF handshake, or you find that it is not required for
  854.                error-free transfer, you can disable it with the -HX option.
  855.  
  856.                Note that both the sender and the receiver must
  857.                simultaneously disable XON/XOFF handshake, otherwise it will
  858.                remain in effect.
  859.  
  860.           -Iidle
  861.                This option controls how idle time is given up under
  862.                multitasking environments.  The possible values are:
  863.                     -I0  Default, do not give up idle time
  864.                     -I1  Spend idle time checking keyboard status
  865.                     -I2  Give up idle time under DesqView
  866.                     -I3  Give up idle time under DoubleDOS
  867.  
  868.           -K
  869.                Keep partial files from aborted transfers.
  870.  
  871.           -O
  872.                Allow receive files to overwrite existing files.
  873.  
  874.           -NB
  875.                Disable buffering of receive and transmit files.
  876.  
  877.           -NC
  878.                Disable Dynamic Code Substitution logic.
  879.                Certain byte codes cannot be transmitted directly over the
  880.                COM link. For instance, the codes for Control-X, Control-S
  881.                and Control-Q must be "escaped" to prevent a conflict with
  882.                flow or program control.
  883.  
  884.                The HS/Link protocol uses a new Dynamic Code Substitution
  885.                system to drastically reduce the number protocol overhead
  886.                and "escape" codes needed to transmit certain data streams.
  887.  
  888.                Highly compressed data files (such as ZIP and GIF files)
  889.                benefit the most, since they often have many byte codes that
  890.                cannot be transmitted directly over the COM link.
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.           HS/Link 1.0 User Documentation                                 15
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.           -NF
  909.                Disable Full screen mode.    ┌─────────────────────────┐
  910.                The standard status display  │HS/Link's Full Screen    │
  911.                takes over the full screen   │status display does not  │
  912.                (except the top 2 lines,     │alter the first 3 display│
  913.                which may contain a BBS      │lines.  The last display │
  914.                status line).                │line is also left alone. │
  915.                                             └─────────────────────────┘
  916.                This option bypasses the
  917.                full screen display and causes a line-oriented output to be
  918.                used.  Use this option if your environment's screen
  919.                management does not allow a full-screen display.
  920.  
  921.           -NM
  922.                Enable Minimal Blocks logic.  Use with caution.
  923.  
  924.           -NT
  925.                Stamp current file time.   This option stamps the current
  926.                time/date on received files, instead of retaining the
  927.                original file time/date.
  928.  
  929.           -NU
  930.                Block uploads.   This option is used by BBS programs that
  931.                cannot (yet) cope with bidirectional uploads.  It is used in
  932.                place of the -U option on the 'download' command line, and
  933.                has the effect of blocking any simultaneous upload requests
  934.                from a user.
  935.  
  936.           -NV
  937.                Disable direct Video for     ┌─────────────────────────┐
  938.                DesqView/DoubleDOS/etc.      │You may need to use -NV  │
  939.                Use this option if you       │to stop display bleeding.│
  940.                experience "bleeding" of     └─────────────────────────┘  
  941.                the status display from one
  942.                partition to another.  Some systems also need this option to
  943.                stop "COM Overrun" error conditions.
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.           HS/Link 1.0 User Documentation                                 16
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.           -Pport
  969.                Use COM port 1-8 (default=1)
  970.  
  971.                Standard COM port definitions:
  972.                     Channel   I/O Port  Interrupt
  973.                      COM1      0x3F8     4
  974.                      COM2      0x2F8     3
  975.                      COM3      0x3E8     4
  976.                      COM4      0x2E8     3
  977.                      COM5      undefined
  978.                      COM6      undefined
  979.                      COM7      0x2E8     5
  980.                      COM8      0x3E8     5
  981.  
  982.                Use -PB and -PI instead of -P to define a non-standard COM
  983.                port.
  984.  
  985.           -PBbase
  986.                Set non-standard COM port base address (specify base address
  987.                decimal, NOT hex).
  988.  
  989.           -PIirq
  990.                Set non-standard COM port IRQ level to 1-7.  This option
  991.                must be used when -PB is used.
  992.  
  993.           -R
  994.                Resume aborted transfer.     ┌────────────────────────┐
  995.                The receiver and             │Use -R -K -O if you want│
  996.                transmitter will verify the  │Download Crash Recovery │
  997.                contents of an existing      └────────────────────────┘
  998.                file, and will begin
  999.                transmission at the first block that does not match.  This
  1000.                provides a reliable means of restarting an aborted transfer,
  1001.                or of updating a modified file.  You must also use -O to
  1002.                recover aborted downloads.
  1003.  
  1004.           -Ssize
  1005.                Sets transmit block size 2-4096 (default=1024) Larger block
  1006.                sizes may result in higher transfer speeds under clean line
  1007.                conditions.
  1008.  
  1009.           -Udir
  1010.                Destination directory for received files (default=current
  1011.                directory)
  1012.  
  1013.           -Wwindow
  1014.                Number of blocks allowed     ┌──────────────────────┐
  1015.                without ACK 1-20             │Use -W4 -S512 -! with │
  1016.                (default=8)                  │PC-Pursuit            │
  1017.                Use -A to establish an       └──────────────────────┘
  1018.                "infinite" window (i.e. no
  1019.                ACK required at all).
  1020.  
  1021.           HS/Link 1.0 User Documentation                                 17
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.                                 Command Line Examples
  1029.           _________________________________________________________________
  1030.  
  1031.           HSLINK -?
  1032.                Display a summary of HS/Link command line formats.
  1033.  
  1034.           HSLINK -P1
  1035.                Download from a BBS using HS/Link.  COM1 will be used at the
  1036.                current port speed.  Received files will go into the current
  1037.                directory.
  1038.  
  1039.           HSLINK -P2 -Uc:\bbsfiles -K
  1040.                Download from a BBS using HS/Link.  COM2 will be used at the
  1041.                current port speed.  Received files will go into the
  1042.                c:\bbsfiles directory.  Partial files from aborted transfers
  1043.                will be kept.
  1044.  
  1045.           HSLINK -P1 -Uc:\bbsfiles -R -K -O
  1046.                Continue an aborted download from a BBS using HS/Link.  COM1
  1047.                will be used at the current port speed.  Received files will
  1048.                go into the c:\bbsfiles directory.
  1049.  
  1050.           HSLINK -Uc:\bbsfiles c:\uploads\*.zip
  1051.                Download from a BBS using HS/Link.  COM1 will be used at the
  1052.                current port speed.  Received files will go into the
  1053.                c:\bbsfiles directory.  Simultaneously upload all *.ZIP
  1054.                files in the c:\uploads subdirectory.
  1055.  
  1056.           HSLINK file1.zip file2.zip file3.zip
  1057.                Upload to a BBS using HS/Link.  COM1 will be used at the
  1058.                current port speed.  Simultaneously downloads selected files
  1059.                from the BBS into the current directory.
  1060.  
  1061.           HSLINK -b115200 -p2 -c -hs -hc -a file1.zip file2.zip
  1062.                Communicate files with a laptop computer using port COM2 and
  1063.                a three wire null modem cable.
  1064.  
  1065.           HSLINK -w4 -s512 -! -uc:\download
  1066.                Download files through PC-Pursuit using a window of 4 blocks
  1067.                and a block size of 512 bytes.  This setting stops most
  1068.                errors when PC-Pursuit is heavily loaded.
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.           HS/Link 1.0 User Documentation                                 18
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.                           Calling HS/Link from COMM programs
  1089.           _________________________________________________________________
  1090.  
  1091.           The HS/Link protocol can be easily installed in most modern COMM
  1092.           programs.  Specific instructions have been prepared for many
  1093.           popular COMM programs, and are available in separate files for
  1094.           download.
  1095.  
  1096.                Communication program         Instructions posted in
  1097.                _____________________         _______________________
  1098.  
  1099.                BOYAN 4.01                    HS-BOY40.ZIP
  1100.                BOYAN 5.0                     HS-BOY50.ZIP
  1101.                {COMMO}                       HS-COMMO.ZIP
  1102.                GT POWER 15.50                HS-GT15.ZIP
  1103.                ProComm Plus and
  1104.                ProComm Plus Test Drive       HS-PCPTD.ZIP
  1105.                QMODEM 4.3                    HS-QMOD.ZIP
  1106.                ROBO COMM 3.1                 HS-RC31.ZIP
  1107.                TELEMATE 2.1                  HS-TMATE.ZIP
  1108.                TELIX 3.1                     HS-TELIX.ZIP
  1109.  
  1110.  
  1111.           Installation instructions for
  1112.           new COMM programs are being       ┌───────────────────────────┐
  1113.           written all the time, so check    │Check The Tool Shop BBS for│
  1114.           with your local bulletin board    │the latest version of      │
  1115.           or on the Tool Shop for           │HS-INST.ZIP.  New COMM and │
  1116.           instructions for additional       │BBS programs are frequently│
  1117.           communication programs.           │added to the library of    │
  1118.                                             │install instructions       │
  1119.                                             │available.                 │
  1120.                                             └───────────────────────────┘
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.           HS/Link 1.0 User Documentation                                 19
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.                           Calling HS/Link from BBS programs
  1149.           _________________________________________________________________
  1150.  
  1151.           The HS/Link protocol can easily be installed in most modern BBS
  1152.           programs as an external protocol.  Specific instructions have
  1153.           been prepared for many popular BBS programs, and are available in
  1154.           separate files for download.
  1155.  
  1156.                BBS program                        Instructions posted in
  1157.                ___________________________        _______________________
  1158.  
  1159.                GAP 5.1                            HS-GAP51.ZIP
  1160.                PCBOARD 14.5                       HS-145.ZIP
  1161.                PCBOARD 14.5a                      HS-145A.ZIP
  1162.                PROBOARD 1.17                      HS-PB117.ZIP
  1163.                PRODOOR 3.43                       HS-PROD.ZIP
  1164.                Searchlight BBS                    HS-SLBBS.ZIP
  1165.                Spitfire BBS version 3.0           HS-SF30.ZIP
  1166.                UltraBBS version 2.08              HS-UB208.ZIP
  1167.                Wildcat! Test Drive v. 2.15        HS-WC215.ZIP
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.           HS/Link 1.0 User Documentation                                 20
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.                                    BBS Requirements
  1209.           _________________________________________________________________
  1210.  
  1211.           HS/Link's demands on a bulletin board program are extremely easy
  1212.           to fill.  The following is all that is necessary:
  1213.  
  1214.           1)   The protocol accepts either
  1215.                a filename to download or a  ┌────────────────────────┐
  1216.                list of files of the form    │Send file lists are text│
  1217.                @DRIVE:\PATH\DOWNLIST.LST.   │files that contain one  │
  1218.                The protocol will send only  │path/filename per line. │
  1219.                the specified files if       └────────────────────────┘
  1220.                filenames (without leading
  1221.                @) are given, or all of the
  1222.                files found in C:\BBS\DOWNLIST.LST if @C:\BBS\DOWNLIST.LST
  1223.                is specified.
  1224.  
  1225.           2)   The protocol will create a DSZLOG compatible log file
  1226.                indicating the names of all files transferred as well as
  1227.                their status (refer to the DSZ standard and the "DSZLOG
  1228.                Statistic Logging" section for the specific contents of the
  1229.                file).
  1230.  
  1231.           3)   Any files found in the
  1232.                DSZLOG file which BBS did    ┌─────────────────────────┐
  1233.                not tell the protocol to     │HS/Link does NOT modify  │
  1234.                SEND are assumed to have     │BBS upload listings!     │
  1235.                instead been RECEIVED by     │The BBS program must     │
  1236.                the protocol.  The BBS       │detect uploads and do    │
  1237.                should then check for the    │it's own file management.│
  1238.                existence of such files and  └─────────────────────────┘
  1239.                if found, ask for
  1240.                descriptions and post them in the upload directory.
  1241.  
  1242.  
  1243.           If the BBS program is not yet
  1244.           able to cope with bidirectional   ┌──────────────────────┐
  1245.           uploads, the -NU option can be    │Use -NU to block all  │
  1246.           used on the 'download' command    │bidirectional uploads.│
  1247.           line to prevent attempts to       └──────────────────────┘
  1248.           perform a bidirectional upload.
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.           HS/Link 1.0 User Documentation                                 21
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.                                      Flow Control
  1269.           _________________________________________________________________
  1270.  
  1271.           Flow Control is required when the sending and receiving computers
  1272.           or modems operate at different speeds, or when computers are
  1273.           unable to simultaneously access disk drives and the COM port. 
  1274.           Flow Control is a software and/or hardware means of slowing down
  1275.           the faster parts of the connection to prevent overloading the
  1276.           slower parts of the system.
  1277.  
  1278.           HS/Link uses both XON/XOFF (software) and RTS/CTS (hardware)
  1279.           handshake when communicating with high speed modems or slow
  1280.           packet switched networks.  The protocol also uses a window
  1281.           algorithm to suspend data transmission if the receiver does not
  1282.           eventually respond to transmitted data.
  1283.  
  1284.           XON/XOFF handshake is a software handshake scheme that should
  1285.           work well on all combinations of modems and networks, and is
  1286.           enabled by default.  If you prefer not to use XON/XOFF handshake,
  1287.           or you find that it is not required for error-free transfer, you
  1288.           can disable it with the -HX option.  Note that both the sender
  1289.           and the receiver must simultaneously disable XON/XOFF handshake,
  1290.           otherwise it will remain in effect.
  1291.  
  1292.           The slow handshake option (-HS) is available for systems with
  1293.           slow disk access.  Use this if you get frequent CRC errors or COM
  1294.           Overrun errors on otherwise clean lines.  The slow handshake
  1295.           option causes XOFF to be sent
  1296.           and/or RTS to be lowered during   ┌───────────────────────────┐
  1297.           any disk activity.  Even when     │The -HS option stops most  │
  1298.           -HS is active, the HS/Link        │Overrun and CRC errors that│
  1299.           protocol should transfer data     │occur during or immediately│
  1300.           very nearly as fast as the        │after disk I/O takes place.│
  1301.           slowest part of the link allows.  └───────────────────────────┘
  1302.  
  1303.           CTS transmitter handshake is automatically enabled, but may
  1304.           conflict with some unusual modem cables or serial ports.  If the
  1305.           CTS signal is not active when HSLINK loads, it will automatically
  1306.           disable CTS handshake for you.  Use the -HC command to manually
  1307.           disable CTS handshake.
  1308.  
  1309.           RTS receiver handshake is used when the slow-handshake option is
  1310.           selected.  This form of handshake causes the RTS line to the
  1311.           modem to be lowered whenever the disk is being accessed.  Some
  1312.           unusual modem or cable arrangements may not tolerate the RTS line
  1313.           being lowered.  In this case, the RTS handshake can be disabled
  1314.           with the -HR option.
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.           HS/Link 1.0 User Documentation                                 22
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.           If you have frequent CRC errors or COM Overrun errors, which
  1329.           persist in spite of the handshake-slow option (-HS), you should
  1330.           consider upgrading your serial port from the usual 8250 to a
  1331.           newer, buffered NS16550AN chip.  The buffered chips are highly
  1332.           recommended if you are operating at high baud rates (>9600) or
  1333.           are accessing extended memory or are multi-tasking.
  1334.  
  1335.           I have also had reports that use of large numbers of dos BUFFERS
  1336.           in CONFIG.SYS can cause overrun errors.  Try reducing the BUFFERS
  1337.           setting to 10 or less, especially if you also use a DISK cache.
  1338.  
  1339.           Some disk cache programs have also been reported to cause overrun
  1340.           errors.  Try turning the cache OFF before calling HSLINK, and
  1341.           turning it back ON again after the transfer is completed.
  1342.  
  1343.           Some older CGA type display adapters and/or BIOS combinations may
  1344.           cause data loss during retrace delays (snow filtering).  If you
  1345.           experience unexplained COM Overrun errors you may solve the
  1346.           problem by adding either -NV (no direct video writes) or -NF
  1347.           (disable full screen display) to the command line.
  1348.  
  1349.  
  1350.  
  1351.  
  1352.                                  Buffered ASYNC chips
  1353.           _________________________________________________________________
  1354.  
  1355.           The National NS16550AN is a pin compatible plug in replacement
  1356.           for 8250 and 16450 serial chips.  It contains hardware buffering
  1357.           to allow faster operation in systems with high interrupt service
  1358.           latency.
  1359.  
  1360.           If you have an NS16550AN
  1361.           buffered UART chip, HS/Link will  ┌───────────────────────────┐
  1362.           automatically enable buffering    │The NS16550AN chip stops   │
  1363.           for better performance with high  │most Overrun and CRC errors│
  1364.           speed modems and multi-tasking    │encountered with COM port  │
  1365.           environments.                     │opening speeds of 9600 and │
  1366.                                             │higher.                    │
  1367.                                             └───────────────────────────┘
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.           HS/Link 1.0 User Documentation                                 23
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.                            Full Streaming Data Transmission
  1389.           _________________________________________________________________
  1390.  
  1391.           The HS/Link protocol allows multiple data blocks to be
  1392.           transmitted before an acknowledgement is required by use of block
  1393.           numbers combined with a window algorithm.
  1394.  
  1395.           The protocol also allows acknowledgements to be combined with
  1396.           data flowing in the opposite direction, making it possible to
  1397.           achieve full streaming simultaneously in both directions over a
  1398.           full duplex communication link.
  1399.  
  1400.           Even though the transmitters operate in full streaming mode, the
  1401.           receivers normally will periodically acknowledge that data is
  1402.           being received.  This acknowledgement can be disabled with the -A
  1403.           option.
  1404.  
  1405.           Recent advances in high speed modem technology have made it
  1406.           possible to simultaneously
  1407.           transfer data at high speeds in   ┌───────────────────────────┐
  1408.           both directions.  This            │The HST modem is not well  │
  1409.           standardized technology is        │suited for bidirectional   │
  1410.           called "V.32", and is available   │transfers.  Switch to V.32 │
  1411.           in many new modems.  The          │modes, if available, for   │
  1412.           bidirectional capabilities of     │higher thru-put.           │
  1413.           HS/Link take full advantage of    └───────────────────────────┘
  1414.           these modems, cutting online
  1415.           time as much as 50% when equal amounts of data are transmitted
  1416.           and received.
  1417.  
  1418.           Some older high speed modems, such as the HST and Hayes-V, do not
  1419.           implement V.32 and are able to transfer quickly in only one
  1420.           direction, while the other direction is relatively slow.  HS/Link
  1421.           will still perform well as a single direction protocol with these
  1422.           modems, but bidirectional
  1423.           thruput will be low due to the    ┌────────────────────────┐
  1424.           "ping pong" effect of the modem   │The "Ping Pong" effect  │
  1425.           switching the high speed channel  │slows bidirectional     │
  1426.           back and forth.                   │transfers on older 9600 │
  1427.                                             │baud modems.            │
  1428.                                             └────────────────────────┘
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.           HS/Link 1.0 User Documentation                                 24
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.                             Full Streaming Error Recovery
  1449.           _________________________________________________________________
  1450.  
  1451.           The HS/Link protocol has the unique ability to recover from many
  1452.           transmission errors without breaking out of full streaming mode.
  1453.  
  1454.           This is important with buffered modems or packet switched
  1455.           networks with long turnaround times.
  1456.  
  1457.           Conventional protocols, such as Zmodem, simply reposition the
  1458.           transmitter after an error, requiring a retransmission of not
  1459.           only the erroneous data, but also the entire stream of data that
  1460.           was in transit at the time the error was detected.
  1461.  
  1462.           The HS protocol can correct bad
  1463.           blocks without retransmitting     ┌───────────────────────────┐
  1464.           intermixed good blocks,           │Full-Streaming-Error-      │
  1465.           resulting in excellent transfer   │Correction cannot stop flow│
  1466.           speeds under moderate line noise  │control failure-related    │
  1467.           conditions.                       │errors.  See the section   │
  1468.                                             │on Flow Control if you have│
  1469.                                             │presistant errors.         │
  1470.                                             └───────────────────────────┘
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.           HS/Link 1.0 User Documentation                                 25
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.                               Dynamic Code Substitution
  1509.           _________________________________________________________________
  1510.  
  1511.           Certain byte codes cannot be transmitted directly over the COM
  1512.           link.  For instance, the codes for Control-X, Control-S and
  1513.           Control-Q must be "escaped" to prevent a conflict with flow or
  1514.           program control.
  1515.  
  1516.           The HS/Link protocol uses a new Dynamic Code Substitution system
  1517.           to drastically reduce number protocol overhead and "escape" codes
  1518.           needed to transmit certain data streams.
  1519.  
  1520.           Highly compressed data files (such as ZIP and GIF files) benefit
  1521.           the most, since they often have many byte codes that cannot be
  1522.           transmitted directly over the COM link.
  1523.  
  1524.           The Dynamic Code Substitution feature can be disabled, if you
  1525.           wish, with the -NC option.
  1526.  
  1527.  
  1528.  
  1529.  
  1530.                             Transmission of Minimal Blocks
  1531.           _________________________________________________________________
  1532.  
  1533.           The HS/Link protocol includes a
  1534.           Minimal Blocks feature, which     ┌───────────────────────────┐
  1535.           when activated, causes the        │Enable Minimal-Blocks with │
  1536.           protocol to strip away repeated   │the -NM option only if you │
  1537.           information from the protocol     │are operating with an error│
  1538.           frames and transmit only the      │free link.                 │
  1539.           minimal amount of information     └───────────────────────────┘
  1540.           required for data flow.
  1541.  
  1542.           This feature results in a savings of over 50% of the normal
  1543.           protocol overhead characters in each block of data, while
  1544.           retaining full data integrity.  All data and control blocks are
  1545.           fully protected by a 32 bit CRC calculation, even when Minimal
  1546.           Blocks is in effect.
  1547.  
  1548.           The final block in a file rarely ends on an exact transfer block
  1549.           boundary.  The HS/Link protocol automatically shortens the final
  1550.           block, eliminating extraneous data transmission at the end of
  1551.           file.
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.           HS/Link 1.0 User Documentation                                 26
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.                                DSZLOG Statistic Logging
  1569.           _________________________________________________________________
  1570.  
  1571.           When you define the environment variable DSZLOG, the HSLINK
  1572.           program will enable transfer logging to the specified filename. 
  1573.           For example, the AUTOEXEC statement:
  1574.                SET DSZLOG=C:\LOGS\LOG.OUT
  1575.           will cause HSLINK to log files transmitted to C:\LOGS\LOG.OUT. 
  1576.           This form of logging provides compatibility with programs that
  1577.           are designed to operate with DSZ or other DSZLOG-type protocols.
  1578.  
  1579.           The log file consists of a single line of text for each file
  1580.           transferred.  Here are some sample log entries:
  1581.  
  1582.   h 227596 10100 bps 1138 cps   0 errors   112 2316 V:\UPLOAD\ZLABP_13.ZIP 0
  1583.   H 177901 10100 bps 1116 cps   1 errors     0  749 U:\PLAY1\ECOMM22.ZIP 0
  1584.   h  16155 10100 bps 1061 cps   0 errors     4  795 W:\ULW\WINROACH.ZIP 0
  1585.   L 136991 10100 bps    0 cps   0 errors    55 1823 W:\ULW\WINDE223.ZIP 11
  1586.   E 152614 10100 bps    0 cps  14 errors    22   38 W:\ULW\CLPGR21C.ZIP 0 2
  1587.  
  1588.           Each line contains the following fields:
  1589.  
  1590.           Size      Description
  1591.           ----      -------------------------------------------
  1592.           1         'H'=file received from remote
  1593.                     'h'=file transmitted to remote
  1594.                     'E'=file receive was aborted
  1595.                     'e'=file transmit was aborted
  1596.                     'L'=lost carrier during file receive
  1597.                     'l'=lost carrier during file transmit
  1598.  
  1599.           7         The length of the file, in bytes.   If the transfer was
  1600.                     aborted, this field will contain the number of bytes
  1601.                     transferred before the transfer was aborted.
  1602.  
  1603.           6         The effective modem-to-modem connect speed.
  1604.           4         Literally ' bps'
  1605.  
  1606.           5         The average transfer rate, in characters per second.
  1607.           4         Literally ' cps'
  1608.  
  1609.           4         The total number of blocks which required
  1610.                     retransmission during the transfer.
  1611.           7         Literally ' errors'
  1612.  
  1613.           6         The number of flow control restrictions.
  1614.           5         The length of the last block transferred in the file.
  1615.           ?         The full pathname of the file which was transferred.
  1616.           ?         The Serial Number of the remote HSLINK, if registered. 
  1617.                     Otherwise 0.
  1618.  
  1619.  
  1620.           
  1621.           HS/Link 1.0 User Documentation                                 27
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.                                 Network Compatibility
  1629.           _________________________________________________________________
  1630.  
  1631.           All file processing is fully
  1632.           network and "share" compatible.   ┌────────────────────────┐
  1633.           HSLINK can be easily installed    │HS/Link automatically   │
  1634.           in multi-user or networked        │enables file sharing in │
  1635.           computers.  This works with DOS   │network environments.   │
  1636.           version 3.0 and later.            └────────────────────────┘
  1637.  
  1638.  
  1639.           When transmitting a file, the file is opened in "allow read, deny
  1640.           none" mode.
  1641.  
  1642.           When receiving a file, the newly created file is created in
  1643.           "allow read, allow write, deny all" mode, which prevents other
  1644.           programs from altering the file which is being created.
  1645.  
  1646.           If a file sharing violation is detected when opening a file, the
  1647.           program passes control to the system's current "critical error"
  1648.           handler.  To automate recovery from file sharing violations, you
  1649.           should consider installing my FATAL14.ZIP program, which will
  1650.           automatically retry after sharing violations, and which will keep
  1651.           a detailed log of all critical errors in a system since the time
  1652.           the program was loaded into memory.
  1653.  
  1654.           All files transmitted or received with HS/Link retain their
  1655.           original exact size and time/date stamp.  No extraneous data is
  1656.           added beyond EOF as with some older protocols.  The current
  1657.           date/time will be stamped on incoming files if the -NT option is
  1658.           used.  Otherwise, the original file's time/date stamp will be
  1659.           retained.
  1660.  
  1661.           When run under DOS 2.x, HSLINK automatically reverts to non-share
  1662.           file modes.
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.           HS/Link 1.0 User Documentation                                 28
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.                                    Auto Downloading
  1689.           _________________________________________________________________
  1690.  
  1691.           It is possible for some terminal
  1692.           programs to support HS/Link auto  ┌───────────────────────────┐
  1693.           downloading by means of           │With HS/Link Auto-Download │
  1694.           "scripts" which wait for the      │You don't have to hit any  │
  1695.           HS/Link "ready" packet, and then  │additional keys to execute │
  1696.           shell out to the HSLINK receiver  │the HSLINK driver.         │
  1697.           protocol.                         └───────────────────────────┘
  1698.  
  1699.  
  1700.           This capability is currently active when HS/Link is installed in
  1701.           {COMMO} and BOYAN 5.0, any may be available soon under many other
  1702.           terminal programs as the respective authors add the capability to
  1703.           recognize external protocol signon signatures.
  1704.  
  1705.  
  1706.           The HS/Link "ready" packet is repeated at 10 second intervals
  1707.           when waiting for the HSLINK receiver to be started.  The format
  1708.           of the "ready" packet is:
  1709.  
  1710.                ^B "R"
  1711.           or in hex,
  1712.                0x02 0x52
  1713.  
  1714.           When this sequence of characters is received during a terminal 
  1715.           session, the HSLINK protocol should be executed.
  1716.  
  1717.  
  1718.           The HSLINK program sends a different "ready" packet when no files
  1719.           need to be sent, but upload files are expected from the remote
  1720.           system.  This "ready" packet signature can be used to implement
  1721.           HS/Link Automatic Upload.  The format of the "upload ready"
  1722.           packet is:
  1723.  
  1724.                ^B "Q"
  1725.           or in hex,
  1726.                0x02 0x51
  1727.  
  1728.           When this sequence of characters is received during a terminal
  1729.           session, an HS/Link upload should be started.
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.           HS/Link 1.0 User Documentation                                 29
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.                                     Error Messages
  1749.           _________________________________________________________________
  1750.  
  1751.           Bad ____ CRC
  1752.                These messages indicate that an error was detected in a
  1753.                control message between the sender and the receiver.  All
  1754.                control packets are protected by a 32 bit CRC calculation to
  1755.                provide highly secure and reliable communication.
  1756.  
  1757.                If you repeatedly receive the "Bad ready packet CRC"
  1758.                message, it may indicate that the internal protocol formats
  1759.                have been changed and that you need to upgrade to a newer
  1760.                beta copy of HSLINK.
  1761.  
  1762.           Bad data CRC (#)
  1763.                This message indicates that an error was detected in a block
  1764.                of data in the file being received.  Error correction is
  1765.                automatic, because of Full-Streaming-Error-Correction, may
  1766.                occur without breaking the stream of data being received.
  1767.  
  1768.                If this message occurs at regular intervals, it is a sign of
  1769.                flow control failure.  In most cases, this can be corrected
  1770.                with the addition of the -HS command line option.
  1771.  
  1772.           COM#: Break!
  1773.           COM#: Framing!
  1774.           COM#: Overrun!
  1775.           COM#: Parity!
  1776.                These messages indicate that an error was detected in the
  1777.                serial port receiver.  Framing and Parity errors often
  1778.                indicate a baud rate mismatch.  Overrun errors usually
  1779.                indicate the need for flow control or for an upgrade to a
  1780.                buffered serial chip.  Overrun errors can often be reduced
  1781.                or eliminated with the use of the -HS command line option.
  1782.  
  1783.           Can't create file '___'
  1784.                This indicates that the received file could not be created. 
  1785.                This usually indicates that the directory specified in the -
  1786.                U command line option is invalid, or that the disk is full.
  1787.  
  1788.           Carrier lost!
  1789.                This indicates that Carrier detect was dropped, aborting the
  1790.                HSLINK session.  If your connection does not provide a
  1791.                carrier detect signal, you can disable this check with the -
  1792.                C command line option.  This is often required when directly
  1793.                connecting two computers by means of a "null modem" cable.
  1794.  
  1795.           Control-X abort!
  1796.                This indicates that the control-x character was received
  1797.                twice in succession, either over the COM port or from the
  1798.                local keyboard.
  1799.  
  1800.  
  1801.           HS/Link 1.0 User Documentation                                 30
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.           Disk write failure!  (#)
  1809.                This usually indicates that the disk is full and that
  1810.                further downloads cannot be received.
  1811.  
  1812.           Flow control released (#### t:# r:#)
  1813.                If output flow has been suspended by either software or
  1814.                hardware flow control for more than 15 seconds, the program
  1815.                will assume that there has been a failure of flow control
  1816.                and will release the hold so data can continue.  The codes
  1817.                in parenthesis indicate which flow controls were active at
  1818.                the time (C=CTS was down, T=transmitter XOFF was pending,
  1819.                R=receiver XOFF was pending, A=transmitter is currently
  1820.                active) and the counts of bytes in the transmit and receive
  1821.                holding queues.
  1822.  
  1823.           FILE was incomplete!  (# #)
  1824.                This message indicates that the transfer was aborted in some
  1825.                way before the specified file was completely received. 
  1826.                Normally incomplete files are erased from disk, but they
  1827.                will be retained of the -K command line option is used.
  1828.  
  1829.           Not allowed to overwrite existing file '___'
  1830.                This indicates that a file was received but there was
  1831.                another file with the same name already in the download file
  1832.                directory.  Either erase the duplicate file, or use the -O
  1833.                option to allow existing files to be overwritten.
  1834.  
  1835.           Insufficient memory to load program.
  1836.           Not enough memory!
  1837.                There was not enough memory available to run HSLINK.  Free
  1838.                additional memory by removing "TSR" software, device
  1839.                drivers, ramdisks or disk caches.  If your COMM program has
  1840.                the option of swapping to DISK or EMS, enable the option to
  1841.                free additional memory for HSLINK's use.  Current beta
  1842.                copies of HSLINK require about 64k of RAM, but the specific
  1843.                amount of memory required is subject to change from beta to
  1844.                beta.  You can reduce the amount of memory required if you
  1845.                use the -HB command line option to disable file buffering.
  1846.  
  1847.           Read failure at #
  1848.                This indicates that there was a disk error reading a file
  1849.                being transmitted.
  1850.  
  1851.           Remote not responding!
  1852.                This indicates that the remote computer did not execute
  1853.                HSLINK and establish a connection within the two minute
  1854.                timeout period.
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.           HS/Link 1.0 User Documentation                                 31
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.                                  Information Messages
  1869.           _________________________________________________________________
  1870.  
  1871.           Receive timeout (#)
  1872.           ACK timeout, resend #
  1873.                This message indicates that it has been too long since the
  1874.                receiver responded to data transmission.  The last data
  1875.                block is repeated in an attempt to wake up the receiver.
  1876.  
  1877.           Advance from block # to #
  1878.                After successful error recovery, the receiver may request
  1879.                the transmitter skip over blocks that have been previously
  1880.                received without error.
  1881.  
  1882.           Block size: #
  1883.                This message indicates the actual block size being used for
  1884.                file transfers.  The block size is controlled by the -W
  1885.                parameter, and may be overridden by the remote computer if
  1886.                the remote uses the -!  (take priority) option.
  1887.  
  1888.           COM#: # bps
  1889.                This message indicates the actual COM port speed in use,
  1890.                either as specified with the -B command line option, or as
  1891.                determined from the current hardware settings.
  1892.  
  1893.           HS/Link finished! (t:# r:#) Exit code = #
  1894.                When HSLINK terminates, it sets the dos ERRORLEVEL to the
  1895.                specified value.  This can be checked in batch files to
  1896.                detect error conditions.  Under normal conditions, HSLINK
  1897.                exits with an ERRORLEVEL of 0.  If, however, the session
  1898.                terminated due to errors, or was aborted by the operator,
  1899.                the ERRORLEVEL will be non-0.  The following ERRORLEVEL
  1900.                codes are possible:
  1901.  
  1902.                ERRORLEVEL          Reason for link termination
  1903.                ----------     ----------------------------------------
  1904.  
  1905.                   0           One or more files transferred successfully
  1906.                   1           ^X typed at local keyboard
  1907.                   2           ^X received over COM port
  1908.                   3           Incompatible BETA versions
  1909.                   4           No files transmitted or received
  1910.                   5           Remote did not respond within 2 minutes
  1911.                   6           Too many framing errors, possible -B mismatch
  1912.  
  1913.                COMM and BBS programs should use the DSZLOG output file to
  1914.                determine more specific details of transfer results.  
  1915.  
  1916.                The (t:# r:#) display indicates the number of files
  1917.                successfully transmitted and received.
  1918.  
  1919.  
  1920.  
  1921.           HS/Link 1.0 User Documentation                                 32
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.           File received OK, # cps, # seconds.
  1929.                The file was received correctly and is now closed.  The
  1930.                average transfer speed is calculated based on the elapsed
  1931.                time between receiving the file open packet and the last
  1932.                byte of the file.  Transfer speeds are calculated using the
  1933.                DOS timer tick, which is not accurate for transfers taking
  1934.                less than 1 second to complete.  For very short transfers, a
  1935.                cps rating of 9999 will be returned.
  1936.  
  1937.           File sent OK, # cps, # seconds.
  1938.                The file was transmitted correctly and is now closed.  The
  1939.                average transfer speed is calculated based on the elapsed
  1940.                time between sending the first byte of the file and the last
  1941.                byte of the file.  Transfer speeds are calculated using the
  1942.                DOS timer tick, which is not accurate for transfers taking
  1943.                less than 1 second to complete.  For very short transfers, a
  1944.                cps rating of 9999 will be returned.
  1945.  
  1946.           File skipped!
  1947.                The transmitter prints this message when the receiver
  1948.                requests the current file be skipped.  This usually happens
  1949.                when the receiver detects a duplicate filename and is not
  1950.                allowed to overwrite existing files.
  1951.  
  1952.           Handshake: CTS XON/XOFF SLOW
  1953.                This message indicates the current combination of flow
  1954.                control options that are in effect.  CTS indicates CTS
  1955.                hardware flow control is active.  XON/XOFF indicates that
  1956.                XON/XOFF software flow control is active.  SLOW indicates
  1957.                that flow will be restrained during disk I/O to prevent
  1958.                overrun errors.
  1959.  
  1960.           Out of sequence # (#)
  1961.                This indicates that the received block was out of sequence,
  1962.                indicating that a block was possibly missed or lost during
  1963.                transmission.  The receiver will request the transmitter to
  1964.                retransmit the missing block(s).
  1965.  
  1966.           Received block # (# bytes) # cps
  1967.                This displays the current status of the file being received. 
  1968.                The current number of blocks and bytes received is displayed
  1969.                after each block is received.  The estimated transfer speed
  1970.                in ch/sec is also displayed.
  1971.  
  1972.           Received block # (# bytes) E#
  1973.                When "E#" is displayed following the received block #
  1974.                message, it indicates that error recovery is in progress,
  1975.                and that the specified block number was in error and is in
  1976.                transit from the transmitter.  When the erroneous block has
  1977.                been received correctly the E# display will advance to the
  1978.                next erroneous block number, or will be erased if no more
  1979.                erroneous blocks are pending.
  1980.  
  1981.           HS/Link 1.0 User Documentation                                 33
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.           Received block # (# bytes) R
  1989.                When "R" is displayed following the received block #
  1990.                message, it indicates that current block has been previously
  1991.                received correctly and is therefore a "repeat" block. 
  1992.                Repeat blocks occur under severe error conditions and are
  1993.                usually corrected automatically.
  1994.  
  1995.           Receiving file: ___ (# blocks, # bytes)
  1996.                This message indicates that a new file is being received
  1997.                from the transmitter.  The file size is displayed in blocks
  1998.                and bytes.
  1999.  
  2000.           Resending block #
  2001.                This message indicates that the receiver has detected an
  2002.                erroneous block and is requesting a retransmission to
  2003.                correct the data.  Data flow continues where it left off
  2004.                prior to the resend, allowing error recovery to take place
  2005.                without breaking out of full streaming mode and without
  2006.                discarding data that is already in transit to the receiver. 
  2007.                This is the basis of Full- Streaming-Error-Correction.
  2008.  
  2009.           Restarting current file
  2010.                This indicates that the receiver was unable to recover from
  2011.                errors encountered in processing the current file being
  2012.                transmitted, and has requested that the file be started
  2013.                again from scratch.
  2014.  
  2015.           Seek from block # to #
  2016.                Under the most severe error conditions, the receiver may
  2017.                request the transmitter to discard data that is in transit
  2018.                to the receiver and to rewind to an earlier position in the
  2019.                file and resume transmission.
  2020.  
  2021.           Sending block # (# bytes/w:#) # cps
  2022.                This is the normal status display while a file is being
  2023.                transmitted.  The message indicates the latest block number
  2024.                to be transmitted, and in parenthesis indicates the number
  2025.                of bytes transmitted and the current number of blocks that
  2026.                have been transmitted without acknowledgement, which
  2027.                represents the size of the transmit "window" that is
  2028.                currently in use.  If this value hangs at the current -W
  2029.                setting, you may benefit from a higher -W setting on the
  2030.                command line.  The estimated transfer speed is also reported
  2031.                in ch/sec.
  2032.  
  2033.           Sending file: ___ (# blocks, # bytes)
  2034.                This message indicates that a new file is being transmitted
  2035.                to the receiver.  The file size is displayed in blocks and
  2036.                bytes.
  2037.  
  2038.  
  2039.  
  2040.  
  2041.           HS/Link 1.0 User Documentation                                 34
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.           Transfer aborted!
  2049.                This message indicates that the current file transfer has
  2050.                been aborted for some reason.  The specific reason for the
  2051.                transfer abort is usually also printed on the screen.
  2052.  
  2053.           Waiting for remote.
  2054.                This message indicates that HSLINK is waiting to handshake
  2055.                with the remote computer.  HSLINK will wait for 60 seconds
  2056.                for the other computer to come online; after that the
  2057.                transfer is aborted.
  2058.  
  2059.           Warning: CTS signal missing!  -HC will be assumed.
  2060.                The CTS hardware handshake is normally enabled by default. 
  2061.                If, on initial loading, HSLINK finds that the CTS signal is
  2062.                down, it assumes that the current hardware configuration is
  2063.                not using CTS handshake and automatically disables further
  2064.                CTS handshake checks.  Use the -HC command line to manually
  2065.                disable CTS handshake.
  2066.  
  2067.           Window: #
  2068.                This indicates the actual number of blocks that are allowed
  2069.                to be in transit without acknowledgement.  This is
  2070.                controlled by the -W parameter, and may be overridden by the
  2071.                remote computer if the remote uses the -!  (take priority)
  2072.                option.
  2073.  
  2074.           Window: NONE
  2075.                This indicates that the -A command line option has been
  2076.                specified, and that the transmitter is required to continue
  2077.                indefinitely without receiving any kind of acknowledgement
  2078.                from the receiver that data is being received correctly.
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.           HS/Link 1.0 User Documentation                                 35
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.                                License and Registration
  2109.           _________________________________________________________________
  2110.  
  2111.           This program is not free!  You are hereby licensed to use this
  2112.           program for a trial period of 30 days free of charge.  If, after
  2113.           30 days, you decide that you would like to continue using HSLINK,
  2114.           you must complete the registration form (REGISTER.FRM) and return
  2115.           it to the author with the required registration fee enclosed.
  2116.  
  2117.           Registration removes the "UNREGISTERED" message and also enables
  2118.           a bar-graphic display of file transfer status, an estimation of
  2119.           remaining time to transfer each file, and a calculation of
  2120.           combined thruput during bidirectional transfers.
  2121.  
  2122.           Introductory HSLINK registration costs $15 US, which includes a
  2123.           registration certificate showing a Serial Number and Password. 
  2124.           Registration fees increase to $20 on 2/1/92, so please register
  2125.           early.  For $25 US, a disk containing the latest release of
  2126.           HSLINK, along with a registration certificate can be obtained. 
  2127.           Printed and bound operation manuals are also available for $15
  2128.           each.  Each registration is valid for use on a single CPU or on a
  2129.           single BBS system (multi-node systems require only a single
  2130.           registration).
  2131.  
  2132.           Please feel free to distribute unregistered HSLINK to your
  2133.           friends and local BBSes as long as all of the files in this
  2134.           archive are included and unmodified.
  2135.  
  2136.  
  2137.           Send your registration payment to:
  2138.  
  2139.                               SAMUEL H.  SMITH
  2140.                               P. O. BOX 4808
  2141.                               PANORAMA CITY, CA 91412-4808
  2142.                               U.S.A.
  2143.  
  2144.  
  2145.           HS/Link registration can also be ordered ON LINE by credit card
  2146.           through any of the Tool Shop BBS phone lines.
  2147.  
  2148.  
  2149.  
  2150.  
  2151.                      LICENSE AGREEMENT FOR SHAREWARE DISTRIBUTORS
  2152.  
  2153.           Shareware distributors may distribute this program as long as the
  2154.           author has been notified, in writing, prior to ANY distribution. 
  2155.           The "per disk" charge may not exceed $6 and the shareware
  2156.           distributor will not change the above license fee for the end
  2157.           user of HSLINK.  End users are not exempt from registering HSLINK
  2158.           with the author at the normal registration fee.
  2159.  
  2160.  
  2161.           HS/Link 1.0 User Documentation                                 36
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.                                        Support
  2169.           _________________________________________________________________
  2170.  
  2171.           HS/Link was Written by Samuel H. Smith
  2172.  
  2173.           Contact me at:
  2174.  
  2175.                          The Tool Shop BBS
  2176.  
  2177.           Phone number        Modem type
  2178.           --------------      --------------------------------------------
  2179.           (818) 891-6780      US Robotics 2400      (free line)
  2180.           (818) 891-3772      US Robotics HST 9600  ($20/yr subscription)
  2181.           (818) 891-1344      Hayes-V series 9600   ($20/yr subscription)
  2182.  
  2183.  
  2184.           You will always find the latest release version of HS/Link on the
  2185.           Tool Shop, as well as a variety of support files and programs.
  2186.  
  2187.  
  2188.           HS/Link is also supported by a number of authorized distributors
  2189.           throughout the world.  Please refer to DISTRIB.DOC for the latest
  2190.           distributor list.
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.                                       DISCLAIMER
  2205.  
  2206.                IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES,
  2207.                INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
  2208.                INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR
  2209.                USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM
  2210.                BY ANY OTHER PARTY.
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.           HS/Link 1.0 User Documentation                                 37
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.                                         Index
  2229.           _________________________________________________________________
  2230.  
  2231.           Aborting a transfer . . . .  6          -! . . . . . . . . 11, 13
  2232.           Auto-download . . . . . . . 29          -@ . . . . . . . . . .  7
  2233.           Auto-Upload . . . . . . . . 29          -@fname  . . . . . . . 13
  2234.           Basic settings  . . . . . .  9          -A . . . . . . . . 11, 13
  2235.           Configuration files                     -B . . . . . . . . . . 10
  2236.                HSCONFIG . . . . . . .  7          -Bbaud . . . . . . . . 13
  2237.                HSLINK.CFG . . . . . .  8          -C . . . . . . . . 10, 13
  2238.                specifying alternate               -CB  . . . . . . . . . 12
  2239.                     configuration                 -CBcolor . . . . . . . 14
  2240.                     files . . . . . .  7          -CM  . . . . . . . . . 12
  2241.           Context sensitive help  . .  9          -CMcolor . . . . . . . 14
  2242.           Crash recovery                          -CT  . . . . . . . . . 12
  2243.                -K . . . . . . . . . . 11          -CTcolor . . . . . . . 14
  2244.                -O . . . . . . . . . . 11          -CW  . . . . . . . . . 12
  2245.                -R . . . . . . . . 11, 17          -CWcolor . . . . . . . 14
  2246.           Date/time stamp                         -E . . . . . . . . . . 10
  2247.                -NT  . . . . . . . . . 10          -Ebaud . . . . . . . . 14
  2248.           DesqView                                -HC  . . . . . . . 10, 14
  2249.                -I2  . . . . . . . . . 15          -HR  . . . . . . . 10, 14
  2250.                -NV  . . . . . . . . . 16          -HS  . . . . . . 6, 9, 14
  2251.           Display bleeding  . . . . .  5          -HX  . . . . . . . 10, 15
  2252.           Display colors  . . . . . . 12          -Iidle . . . . . . . . 15
  2253.           DoubleDOS                               -K . . . . . . . . 11, 15
  2254.                -I3  . . . . . . . . . 15          -NB  . . . . . . . 11, 15
  2255.                -NV  . . . . . . . . . 16          -NC  . . . . . . . 11, 15
  2256.           DSZLOG  . . . . . . . . . . 27          -NF  . . . . .  5, 12, 16
  2257.           ERRORLEVEL  . . . . . . . . 32          -NM  . . . . . . . . . 16
  2258.           Errors                                  -NT  . . . . . . . 10, 16
  2259.                -HS  . . . . . . . . .  6          -NU  . . . . . . . . . 16
  2260.                -NV  . . . . . . . . . 23          -NV  . . . . .  5, 12, 16
  2261.                COM Overrun  . . . 14, 23          -O . . . . . . . . 11, 15
  2262.                Error messages . . . . 30          -P . . . . . . . . . .  9
  2263.           Exit codes  . . . . . . . . 32          -PBbase  . . . . . . . 17
  2264.           File buffering  . . . . . . 11          -PI  . . . . . . . . . 10
  2265.           File sharing  . . . . . . . 28          -PIirq . . . . . . . . 17
  2266.           Flow control  . . . . . . . 22          -Pport . . . . . .  6, 17
  2267.                -HC  . . . . . . . . . 10          -R . . . . . . . . 11, 17
  2268.                -HR  . . . . . . . . . 10          -S . . . . . . . . . . 11
  2269.                -HS  . . . . . . . . .  6          -Ssize . . . . . . . . 17
  2270.                -HX  . . . . . . . . . 10          -U . . . . . . . . . .  9
  2271.           HSCONFIG  . . . . . . . . .  7          -Udir  . . . . . .  6, 17
  2272.           HST . . . . . . . . . . . . 24          -W . . . . . . . . . . 11
  2273.           Installation                            -Wwindow . . . . . . . 17
  2274.                In BBS programs  . . . 20     PC-Pursuit
  2275.                In COMM programs . . . 19          -W . . . . . . . . . . 17
  2276.           Non-standard COM ports  10, 17          Example  . . . . . . . 18
  2277.                -PI  . . . . . . . . . 10     Registration  . . . . . . . 36
  2278.           NS16550AN . . . . . . . . . 23     V.32  . . . . . . . . . . . 24
  2279.           Options . . . . . . . . . . 10     Zmodem  . . . . . . . . . . 25
  2280.  
  2281.           HS/Link 1.0 User Documentation                                 38
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.           HS/Link 1.0 User Documentation                                 39
  2342.